.. _cemLtcReadLatch:

cemLtcReadLatch
===============
---------------


SYNOPSIS
--------


.. code-block:: none

  VT_I4 cemLtcReadLatch(
    VT_I4 Axis,
    VT_I4 Counter,
    VT_PR8 LatchedPos
  )



DESCRIPTION
-----------


- 지정한 축의 현재 래치 된 카운트 값을 반환합니다. 이때 반환되는 위치 값의 단위는 논리적 거리 단위(Unit Distance)가 적용됩니다..



PARAMETER
---------


- Axis : : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상,. (최대 통합 축 개수 - 1) 이하의 값을 축 번호로 설정할 수 있습니다. 

- Counter : 읽을 래치 카운터를 지정합니다. 이 값은 다음과 같습니다. 

- LatchedPos : 지정한 축의 래치 된 카운트 값을 반환합니다. 이때 반환되는 위치 값의 단위는 논리적 거리 단위가 적용됩니다. 

+-----------------+-----------------------------------------------+
| Value           | Meaning                                       |
+=================+===============================================+
| 0 (cemCNT_COMM) | 명령 위치 카운터. (Command position counter)  |
+-----------------+-----------------------------------------------+
| 1 (cemCNT_FEED) | 실제 위치 카운터. (Feedback position counter) |
+-----------------+-----------------------------------------------+
| 2 (cemCNT_DEV)  | Deviation 또는 펄스 출력 속도.                |
+-----------------+-----------------------------------------------+



RETURN VALUE
------------
+----------------+-----------+
| Value          | Meaning   |
+================+===========+
| 음수           | 수행 실패 |
+----------------+-----------+
| 0 (ceERR_NONE) | 수행 성공 |
+----------------+-----------+

Example
-------
.. code-block:: cpp
 :linenos:


 
 // 0 번 축의 래치 카운트를 Feedback position counter 로 설정하고 래치된 카운트 값을 반환합니다.
 long nLtcCounter = cemCNT_FEED;
 double fLatchedPos = 0.0f;
 cemLtcReadLatche( cemX1, nLtcCounter, &nLatchedPos );